InsetRect

InsetRect
Header:	Quickdraw.h		Carbon status:	Supported

Shrinks or expands a rectangle.

void InsetRect (
    Rect *r, 
    SInt16 dh, 
    SInt16 dv
);

Parameter descriptions

r: A pointer to the rectangle to alter.
dh: The horizontal distance to move the left and right sides in toward or outward from the center of the rectangle.
dv: The vertical distance to move the top and bottom sides in toward or outward from the center of the rectangle.

DISCUSSION

The InsetRect function shrinks or expands the rectangle that you specify in the r parameter: the left and right sides are moved in by the amount you specify in the dh parameter; the top and bottom are moved toward the center by the amount you specify in the dv parameter. If the value you pass in dh or dv is negative, the appropriate pair of sides is moved outward instead of inward. The effect is to alter the size by 2*dh horizontally and 2*dv vertically, with the rectangle remaining centered in the same place on the coordinate plane.

If the resulting width or height becomes less than 1, the rectangle is set to the empty rectangle (0,0,0,0).

If the points or rectangles supplied to this function are defined in a graphics port other than your current graphics port, you must convert them to the local coordinate system of your current graphics port. You can accomplish this by using the SetPort function to change to the graphics port containing the points or rectangles, using the LocalGlobal function to convert their locations to global coordinates, using SetPort to return to your starting graphics port, and then using the GlobalToLocal function to convert the locations of points or rectangles to the local coordinates of your current graphics port.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.